grid functions - continued

XgrGridTypeNameToNumber ( gridType$, @gridType )

XgrGridTypeNameToNumber() returns the gridType number previously assigned to gridType$ . If gridType$ was never registered, -1 is returned in gridType . 

XgrGridTypeNumberToName ( gridType, @gridType$ )

XgrGridTypeNumberToName() converts gridType into the corresponding gridType$ . If gridType has not been assigned, an empty string is returned in gridType$ .

gridType=0 is "Coordinate" and gridType=1 is "Image".

XgrRegisterGridType ( gridType$, @gridType )

XgrRegisterGridType() registers gridType$, assigns it a grid type number, and returns it in gridType . If gridType$ already exists, XgrRegisterGridType() returns the already established grid type number.

XgrSetGridBorder ( grid, border, borderUp, borderDown, borderFlags )

XgrSetGridBorder() sets the current grid border attribute that specifies the border style in the XgrDrawBorder() functions, plus additional border values borderUp , borderDown , borderFlags .

XgrSetGridBorderOffset ( grid, left, top, right, bottom )

XgrSetGridBorderOffset() sets the current border offset from the left , top , right , and bottom of grid. These values determine how far the grid border is drawn from the edge of the grid by the XgrDrawBorder() functions.

XgrSetGridBoxGrid ( grid, x1Grid, y1Grid, x2Grid, y2Grid )

XgrSetGridBox() sets the (upper-left:lower-right) of the grid-box to grid coordinates (x1Grid,y1Grid:x2Grid,y2Grid) . This does not change the position or size of the grid, and values of x2Grid,y2Grid that are inconsistent with grid width and height are adjusted to make them so.

XgrSetGridBoxScaled ( grid, x1#, y1#, x2#, y2# )

XgrSetGridBoxScaled() sets the (upper-left:lower-right) corners of the grid-box to scaled coordinates (x1#,y1#:x2#,y2#) .

This does not change the position or size of the grid.

XgrSetGridBuffer ( grid, bufferGrid )

XgrSetGridBuffer() sets bufferGrid as the image grid to perform automatic buffering for grid . The grid type of bufferGrid must be image grid, which is 1 . bufferGrid = 0 means no buffer. 

XgrSetGridCharacterMapArray ( grid, @map[] )

XgrSetGridCharacterMapArray() sets the character map array for the specified grid .

XgrSetGridDrawingMode ( grid, drawingMode, lineWidth, lineStyle )

XgrSetGridDrawingMode() sets drawMode for grid .

0 in drawingMode means SET drawing mode, where pixels are drawn with the specified color. 1 means XOR drawing mode, where pixels are drawn with the color generated by a bitwise XOR of the current pixel color and the specified color.

lineWidth,lineStyle may not be implemented.

XgrSetGridFont ( grid, font )

XgrSetGridFont() sets the font that controls the typeface, point size, and drawing angle of text drawn in grid . 

XgrSetGridFunction ( grid, func )

XgrSetGridFunction() sets the func address of the grid function assigned to grid . XgrProcessMessages() calls this function when it processes a message for grid . 

XgrSetGridPositionAndSize ( grid, x, y, width, height )

XgrSetGridPositionAndSize() positions and resizes grid . The upper-left corner of its grid-box is set to parent local coordinates (x,y), and its (x2Grid,y2Grid) grid coordinates are adjusted if the size is changed.

XgrSetGridState ( grid, state )

XgrSetGridState() sets the disable/enable state of grid to state . state=0 disables grids.

GraphicsDesigner does not consider disabled grids in its search to find the grid to send mouse messages to, which effectively makes disabled grids invisible or non-existent to the mouse.

XgrSetGridTimer ( grid, interval )

XgrSetGridTimer() sets a millisecond timer for grid to interval . When the timer counts down to zero it stops and a Timer message for grid is added to the message queue.

XgrSetGridType ( grid, gridType )

XgrSetGridType() sets the gridType of grid . This has no effect on the functionality of GraphicsDesigner, except that gridType=0 and gridType=1 grids do not receive event messages.